<div id="tools_manual">
    <h1>Tools Manual</h1>
    	<p>
    		"Tools" is a small Module to provide Auto Tasks to clear cache-/templates_c directory, maintain Database tables and clear sessions. Also
    		it can run simple (only Database) and full (Database with TRUST, themes und uploads-directory) Backup. All funktions
    		can also triggered by Button-click or as Cron Job. Both with possibility to move the backup via ftp to another destination.
    	</p>
    <h2 id="index">Index</h2>
    <ul>
    	<li><a href="#keyfeatures">Keyfeatures</a></li>
    	<li><a href="#firsstart">First Start</a></li>
    	<li><a href="#tools_cron_job">Cron-Jobs</a></li>
    	<li><a href="#module_upload">Module upload</a></li>
    	<li><a href="#theme_upload">Theme upload</a></li>
    	<li><a href="#ftp_backup">FTP-Backup</a></li>
    	<li><a href="#mail_notif">E-Mail Notifications</a></li>
    	<li><a href="#tools_footer">Conclusion</a></li>
    </ul>
    <h2 id="keyfeatures">Keyfeatures</h2>
		<ul>
			<li>Optimizing, repairing and analyze your Database tables as Cron-Job and Auto task</li>
			<li>"templates_c" and/or "cache" clean-up</li>
			<li>Sessions clean-up</li>
			<li>Database-Backup and full Backup including Trust, themes and Uploads-directory from back end or via Cron-Job (additional FTP-Backup possible)</li>
			<li>Themes and modules can be uploaded to default destination</li>
		</ul>
	<h2 id="firsstart">First Start</h2>
	<h3>How to use Tools</h3>
		<p>
			The "Tools" are small helper tu trigger maintenance of your Webseite or as a little help while developing and designing ImpressCMS using following features:
		</p>
			<ul>
				<li><b>Maintain Database:</b>
					This button triggers "CHECK TABLE", "REPAIR TABLE",
					"ANALYZE TABLE" and "OPTIMIZE TABLE" to keep your icms-tables clean and fast ;-)
				</li>
				<li>
					<b>"templates_c" and "cache" clean-up:</b>
					cleans each of the folders.
				</li>
				<li>
					<b>"sessions" clean-up:</b>
					Truncate "sessions" table.
				</li>
			</ul>

			<p>
				The tools can easily be triggered by Auto Tasks. Please call in ACP: System &raquo; System Tools &raquo; Auto Tasks.
				There you can find a few new Auto Tasks. At least you can decide, if you like to trigger all tools at once or even some of them.
			</p>
	<h3>The Backup</h3>
		<p>You have two options to trigger backups:</p>
		<ul>
			<li>
				<b>Simple backup</b>
				Triggers a full DB-Backup and stores this packed in a Zip-File in your Trust-directory in &laquo;modules/tools/backup/db_backup.zip&raquo;
			</li>
			<li><b>full backup:</b>
				Triggers a full DB-Backup and stores including Trust-Path, Upload-and themes directory in a Zip-File into your Trust
				 &laquo;modules/tools/backup/backup_sql.zip&raquo; or submit your data via FTP to another Server.
				<div class="tools_attention">
					<p>
						ATTENTION: This should NOT be called from Backend, only as <a href="#tools_cron_job" title="Cron-Job">Cron-Job</a>! You might run for
						test the backup with ftp, but it's highly recommanded to use this feature only without ftp or as Cron Job!</p>
				</div>
			</li>
		</ul>
	<h2 id="tools_cron_job">Cron Jobs</h2>
		<p>Cron-Jobs werden beim Webhoster eingerichtet, um Aufgaben automatisch vom Server ausführen zu lassen. Bei Backups ist das A: sicher(er) und B: weniger Ressourcen-Lastig wie ein
			Backup via Auto Task. Um den Cron-Job ausführen zu können bitte beim Webhost nachschauen. In das Ziel des Cronjobs muss die Url des gewüschten Jobs eingegeben werden und
			die Parameter: uname=user&password=password mit angehängt. Username und password bitte mit denen eines Users ersetzen, der administrativen Zugriff auf das Tools-Modul hat</p>
			<p><b><i>www.meine-seite.de/modules/tools/include/cron/backup.php?uname=user&password=password</i></b> <span class="tools_highlighted">Führt ein Datenbank-backup OHNE die Ordner Trust und uploads aus</span></p>
			<p><b><i>www.meine-seite.de/modules/tools/include/cron/full_backup.php?uname=user&password=password</i></b> <span class="tools_highlighted">Führt ein Datenbank-backup MIT den Ordner Trust, themes und uploads aus</span></p>
			<p><b><i>www.meine-seite.de/modules/tools/include/cron/tools.php?uname=user&password=password</i></b> <span class="tools_highlighted">Führt alle Tools aus</span></p>
			<p>Wenn Probleme auftreten (z.B. nicht ausgeführter Cron), kann man jeweils noch "&debug=1" aufrufen</p>
			<p>
				Je nach Server/Webhost kann man auch den Cron-Job via Console/SSH ausführen. in diesem Fall bisste die parameter in der gleichen Reihenfolge übergeben.
				(<b>ssh user@localhost /path/to/my/root/modules/tools/include/cron/full_backup.php -username=user -password=password -debug=1</b>). Bitte in diesem Fall in der Config einstellen, dass die Cron-Jobs
				nur via SSH laufen dürfen!
			</p>
			<div class="tools_attention">
				<p>
					Für den Fall, dass die Cron-Jobs <span class="tools_highlighted">nicht</span> via SSH ausgeführt werden können, wird empfohlen einen Verzeichnisschutz anzulegen!
					Beispieldateien sind im Ordner <b>tools/include/cron/</b> enthalten. Einfach an die eigenen Daten angleichen und hochladen. Nicht vergessen, die Daten im
					Cron Job bei dem Webhoster mit anzugeben! Die meisten Webhoster bieten an, diesen Verzeichnisschutz zu generieren. Ansonsten nutzen Sie	google.de ;-)
				</p>
			</div>
	<h2 id="module_upload">Upload Modules</h2>
		<p>
			Modul-upload can be used, to install or update Modules (update is dependent on permissions). Go to "Upload Modules/Themes". You should
			 see an upload-Form. Is your Module-Folder not writable you'll see an error message and you need to adjust permissions first.
			Please use a ftp-software to take care of the permissions
		</p>
		<p>
			To upload Modules, they need to be packed in "zip". Your Zip-File should:
		</p>
		<ul>
			<li>contain only the Module-folder OR</li>
			<li>1 Modul zipped like /modules/modul-ordner</li>
		</ul>
		<p>
			I will not take care of multiple modules and
		</p>
		<div class="tools_attention">
			<p>
				Some modules contains als a new library (Folder "libraries") or something else. In this case you might not be able to use module upload!
			</p>
		</div>
	<h2 id="theme_upload">Upload Themes</h2>
		<p>
			Theme-uploads can be used, to install or update Themes. Got to Tools/"Upload Module/Themes". If you have write permissions to theme folder, you should see
			an upload-Form. If your Themes-Folder isn't writable you'll see an error message and you need to adjust permissions first.
			So please use a FTP-Software to adjust your folder permissions.
		</p>
		<p>
			To upload Themes, they need to be packed as "zip". Your zip should:
		</p>
		<ul>
			<li>only the folder of your Theme OR</li>
			<li>1 Theme zipped like /themes/theme-folder OR</li>
			<li>multiple Themes zipped like: /themes/theme-folder1, /themes/theme-folder2 etc</li>
		</ul>
		<div class="tools_attention">
			<p>
				Please take care of the file size of your zip. Only up to 2mb are supported!
			</p>
		</div>
	<h2 id="ftp_backup">FTP-Backup</h2>
		<p>
			To make use of FTP-Backup, please go to module preferences and set <b>Enable FTP</b> to Yes, and fill the form with FTP-URL, user and password.
			If your account doesn't ends in the backup folder, you can set a path, where to go for backup. Please get sure, the folder is writable!</p>
		<p>Full and simple backups should now be moved to your FTP-Folder.</p>
	<h2 id="mail_notif">E-Mail-Notification</h2>
		<p>
			You can get E-Mail reports of Tools-Backups.The module sends an E-Mail to your Admin-E-Mail, to be set in in System &raquo; Configuration &raquo; Main Preferences. To send
			 the E-Mail you need to setup System &raquo; Configuration &raquo; Preferences &raquo; E-Mail-Setup.
		</p>
	<div id="tools_footer">
		<h2>Abschluss</h2>
			<p>
				Thank you for using 'Tools' Module. If you're running into trouble, please use our
				<a href="http://www.impresscms.de/modules/forum/viewforum.php?forum=30" title="ImpressCMS Community Forum" rel="external">ImpressCMS Community Forum</a> to report.
				You have suggestions for additional functionality or suggestions about usability? No Problem! We can talk about.
				Please also use our <a href="http://www.impresscms.de/modules/forum/viewforum.php?forum=30" title="ImpressCMS Community Forum" rel="external">
				ImpressCMS Community Forum</a>, too!
			</p>
			<p>
				To follow recent updates you can make a checkout of
				<a href="https://code.google.com/p/amaryllis-modules/source/browse/#svn%2Ftrunk%2Ftools"
				title="'Tools' SVN on Google Code" rel="external">'Tools' SVN on Google Code</a>.
			</p>
	</div>
</div>